home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / text / mconv_19.lha / MausConv.doc < prev    next >
Encoding:
Text File  |  1995-01-29  |  6.5 KB  |  170 lines
  1.         MausConv Version 1.9 Benutzer-Dokumentation
  2.  
  3.  
  4. Was macht MausConv?
  5.  
  6.     MausConv ist ein DFÜ-Utilitie, das wohl nur im Zusammenhang mit einer
  7.     Maus-Mailbox und dem Maustauschprogramm Matiga sinnvoll ist. Es werden
  8.     möglichst viele IBM-Sonderzeichen in die entsprechenden Amiga-Zeichen
  9.     verwandelt.
  10.  
  11.  
  12. Wieso noch ein IBM<->Amiga Konverter?
  13.  
  14.     Ganz einfach: MausConv konvertiert nur die Zeichen, die auf dem Amiga
  15.     sowieso schon keine Umlaute sind. Taucht also im Text ein Zeichen auf,
  16.     das eigentlich ein Amiga-Umlaut ist, so wird dieses Zeichen nicht
  17.     ersetzt. Dies macht deshalb Sinn, weil in der Maus zwar prinzipiell
  18.     IBM-Umlaute verwendet werden, in manchen Amiga-Gruppen manche Leute
  19.     aber dennoch Amiga-Umlaute verwenden.
  20.  
  21.     Abgesehen davon braucht das MausTausch-Programm Matiga (aus welchem
  22.     Grund auch immer) unbedingt als Zeilenende-Zeichen ein CRLF (wie PCs)
  23.     und stürzt bei einem einfachen LF (wie beim Amiga üblich) ab. Die
  24.     meisten anderen Konvertierer ersetzen jedoch CRLF durch LF.
  25.  
  26.     Wieso ich dann nicht gleich die Maus wandeln lasse, wo das doch geht?
  27.     Auch dafür gibt es einen Grund: Die Maus wandelt nur IBM-Umlaute und
  28.     läßt alle anderen Zeichen unberührt. Ist zwar im Prinzip das, was
  29.     MausConv auch macht, nämlich die Amiga-Umlaute unberührt zu lassen,
  30.     aber dann werden Sonderzeichen wie "µ" oder "ñ" auch nicht übersetzt.
  31.  
  32.  
  33. Aufruf:
  34.  
  35.     MausConv ist ein reines CLI-Programm. Der Aufruf lautet:
  36.  
  37.         Aufruf: MausConv <Eingabedatei> <Ausgabedatei> maus2ami
  38.           oder: MausConv <Eingabedatei> <Ausgabedatei> ami2maus
  39.  
  40.     Am besten wird es in Matiga.Config mit folgenden Zeilen eingetragen:
  41.  
  42.         Depack_String = MausConv <PFAD>/Outfile.txt T:Outfile.txt maus2ami
  43.         Enpack_String = MausConv T:Infile.txt <PFAD>/Infile.txt ami2maus
  44.  
  45.     Dabei ist <PFAD> natürlich durch den entsprechenden Pfad zum Infile und
  46.     Outfile zu ersetzen.
  47.  
  48.     Falls der MausTausch mit gepackten Files erfolgt, muß man sich zwei
  49.     Batchdateien schreiben, die etwa so aussehen könnten:
  50.  
  51.         .key Pfad/A
  52.         ;MausOut: Batch zum Entpacken des Outfiles
  53.         lha x <Pfad>/Outfile
  54.         t: MausConv t:Outfile.txt t:Outfile.tmp maus2ami delete
  55.         t:Outfile.txt rename t:Outfile.tmp t:Outfile.txt
  56.  
  57.         .key Pfad/A
  58.         ;MausIn: Batch zum Packen des Infiles
  59.         MausConv t:Infile.txt t:Infile.tmp ami2maus
  60.         delete t:Infile.txt
  61.         rename t:Infile.tmp t:Infile.txt
  62.         lha -0 a <Pfad>/Infile t: Infile.txt
  63.  
  64.     Dann ist in Matiga.Config folgendes einzutragen (hier natürlich <Pfad>
  65.     ersetzen):
  66.  
  67.         Depack_String = execute MausOut <Pfad>
  68.         Enpack_String = execute MausIn <Pfad>
  69.  
  70.     Die Batchfiles und der Eintrag in Matiga.Config sind nur Beispiele und
  71.     absolut ungetestet. Ich übernehme deshalb keine Gewähr, daß diese ohne
  72.     Modifikationen funktionieren (obwohl ich keinen Grund sehe, wieso sie
  73.     nicht funktionieren sollten).
  74.  
  75.  
  76. Compiler:
  77.  
  78.     MausConv wurde mit DICE 3.0 entwickelt. Es müßte allerdings auf allen
  79.     Compilern lauffähig sein (nach dem expliziten Öffnen der dos.library).
  80.     Mitgeliefert wird MausConv.DICE für die kommerzielle DICE-Version und
  81.     ein DMakefile für die Freeware Version von DICE.
  82.  
  83.  
  84. Legal Stuff:
  85.  
  86.     MausConv ist FreeWare, d.h. es darf frei weitergegeben werden, solange
  87.     das Archiv unverändert gelassen wird. Die Rechte am Source-Code bleiben
  88.     jedoch vollständig beim Autor.
  89.     Jeder darf das Programm verändern, aber das veränderte Programm darf
  90.     nicht an Dritte weitergegeben werden. Wenn man will, daß eine
  91.     Veränderung fest in das Programm aufgenommen wird, dann muß man sich
  92.     mit dem Autor in Verbindung setzen.
  93.  
  94.  
  95. Autor:
  96.  
  97.     Helmut Kindler
  98.     Stirnbrandstraße 13         oder Breitestraße 34
  99.     70193 Stuttgart                  72513 Hettingen
  100.  
  101.     Tel: 0711/653277
  102.     Fax: 0711/650260
  103.  
  104.     E-Mail: Helmut_Kindler@S4.maus.de
  105.             Helmut_Kindler@BL.maus.de
  106.             helmut@ifswps4.fertigungstechnik.uni-stuttgart.de
  107.  
  108.  
  109. History:
  110.  
  111. V1.9 (29.1.95)
  112.     In m2a wurde der Code 96 (PC: `) in Code 180 (Amiga: ´) gewandelt. Da
  113.     das Zeichen 96 aber in der normalen ASCII-Tabelle liegt, war dies nicht
  114.     nur überflüssig, sondern führte auch dazu, daß Mails mit Files, die mit
  115.     UUEndCode codiert waren, nach dem Abspeichern aus Matiga heraus nicht
  116.     decodiert werden konnten. Sorry, falls dies zu Unannehmlichkeiten
  117.     geführt hat.
  118.  
  119. V1.8 (13.11.94)
  120.     Entfernung eines Debug-Hunks, der noch aus Test-Zeiten in MausConv
  121.     enthalten war. VT meldete mit älteren Version einen Debug-Hunk-Fehler.
  122.     Vielen Dank an Michael Winkler, der mich durch eine Mail in der Gruppe
  123.     Amiga darauf aufmerksam gemacht hat. Duch die Entfernung des Hunks
  124.     wurde die Länge von MausConv von 6168 Bytes auf 4592 Bytes reduziert.
  125.  
  126. V1.7 (1.11.94)
  127.     Optimierung der Code-Tabellen:
  128.     a2m: Code 248 (Amiga: ø) wurde versehentlich nicht gewandelt.
  129.          Code 216 (Amiga: Ø) wird nun zu Code 233 (PC: großes Theta)
  130.     m2a: Code 233 (PC: großes Theta) wird nun zu Code 216 (Amiga: Ø)
  131.          Code 235 (PC: kleines Delta) wird nun zu Code 240 (Amiga: ð)
  132.          Code 237 (PC: kleines Phi) wird nun zu Code 248 (Amiga: ø)
  133.  
  134. V1.6 (27.10.94)
  135.     Kaum hat man mal alten Source-Code rausgekramt, dann fallen einem auch
  136.     gleich jede Menge Verbesserungen ein. Durch die Umstellung von
  137.     Standart-C-IO-Routinen auf die Routinen des Amiga-DOS wurde die Größe
  138.     des fertigen Programms glatt halbiert - bei gleicher Funktionalität.
  139.     Das ganze Programm müßte sogar noch einen Tick schneller sein, was aber
  140.     praktisch kaum meßbar sein dürfte.
  141.  
  142. V1.5 (27.10.94) - nicht veröffentlicht -
  143.     Und noch ein paar Fehler entdeckt:
  144.     - In m2a wurde das Zeichen 135 (PC:ç) irrtümlich nicht gewandelt.
  145.     - Dafür wurde das Zeichen 155 (PC:¢) in 231 (Amiga:ç) gewandelt.
  146.     - In a2m war es dann genau umgekehrt.
  147.  
  148. V1.4 (19.9.94)
  149.     In m2a wurde der Code 245 (PC: unterer Teil des Integralzeichens,
  150.     Amiga: õ) durch 228 (ä) ersetzt. Scheinbar hat da irgendwer einen etwas
  151.     komischen Zeichensatz. Ich weiß nicht was das für ein Zeichensatz sein
  152.     soll. Weiß das jemnand? Trotzdem habe ich die Konvertierung mal
  153.     eingebaut, da mir lästige Betreffs wie z.B. "DIE ErklSrung" auf den
  154.     Geist gegangen sind.
  155.  
  156. V1.3 (30.8.94)
  157.     In m2a wurde das Paragraphen-Zeichen nicht richtig gewandelt.
  158.     Vielen Dank an Dieter Seidenberger für den Bug-Report.
  159.  
  160. V1.2 (19.8.94)
  161.     Code 158 (PC: 'Pt', Atari: 'ß') von 'P' auf 'ß' geändert.
  162.  
  163. V1.1 (1.8.94)
  164.     - Code 127 wurde durch 35 (SPACE) ersetzt,
  165.     - Code 223 (Amiga: ß) war aus Versehen auch auf 127 gesetzt.
  166.  
  167. V1.0 (29.7.94)
  168.     erste lauffähige Version.
  169.  
  170.